Skip to content

update dependencies to 3.10#85

Merged
dovholuknf merged 2 commits into
mainfrom
update-to-3.10
May 13, 2026
Merged

update dependencies to 3.10#85
dovholuknf merged 2 commits into
mainfrom
update-to-3.10

Conversation

@dovholuknf
Copy link
Copy Markdown
Member

this should hopefully get resolved with the 4.0 release.

Docusaurus 3.10.1 + future.v4 = broken build. Two fixes:

  1. Drop invalid config.format='detect' from per-plugin docs config -- 3.10's schema rejects it. Site-level
    markdown.format='detect' already covers it.

  2. Polyfill the {#id} heading anchors and <!-- --> comments in upstream .mdx from _remotes/. Under v4-strict
    MDX, both blow up micromark before Docusaurus's built-in heading-id plugin gets a turn. Can't fix the files
    (_remotes/ is upstream, gets clobbered on every build-docs.sh). MDX wontfix'd it, Docusaurus can't-repro'd it.
    Site-level markdown.preprocessor rewrites the source pre-tokenization; companion remark plugin promotes the
    placeholder into a real <h2 id="..."> so Docusaurus's anchor validator sees it. Same shape Docusaurus's own MDX2
    migration used.

Refs:

@vercel
Copy link
Copy Markdown

vercel Bot commented May 13, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
docusaurus-shared Ready Ready Preview, Comment May 13, 2026 2:37am

Request Review

@dovholuknf dovholuknf merged commit 68ea3d5 into main May 13, 2026
5 checks passed
@dovholuknf dovholuknf deleted the update-to-3.10 branch May 13, 2026 02:37
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants